Added bindings and documentation for host.send_debug_keys and host.get_log.
authorEwan Mellor <ewan@xensource.com>
Mon, 9 Apr 2007 10:39:27 +0000 (11:39 +0100)
committerEwan Mellor <ewan@xensource.com>
Mon, 9 Apr 2007 10:39:27 +0000 (11:39 +0100)
Signed-off-by: Ewan Mellor <ewan@xensource.com>
docs/xen-api/xenapi-datamodel.tex
tools/libxen/include/xen_host.h
tools/libxen/src/xen_host.c

index 2ed8ab1350a3a66576776180b92b48895249c202..3c38727c50374a49a0046fbbe9b3bf18a4a70148 100644 (file)
@@ -4948,6 +4948,72 @@ string
 
 
 dmesg string
+\vspace{0.3cm}
+\vspace{0.3cm}
+\vspace{0.3cm}
+\subsubsection{RPC name:~get\_log}
+
+{\bf Overview:} 
+Get the host's log file.
+
+ \noindent {\bf Signature:} 
+\begin{verbatim} string get_log (session_id s, host ref host)\end{verbatim}
+
+
+\noindent{\bf Arguments:}
+
+\vspace{0.3cm}
+\begin{tabular}{|c|c|p{7cm}|}
+ \hline
+{\bf type} & {\bf name} & {\bf description} \\ \hline
+{\tt host ref } & host & The Host to query \\ \hline 
+
+\end{tabular}
+
+\vspace{0.3cm}
+
+ \noindent {\bf Return Type:} 
+{\tt 
+string
+}
+
+
+The contents of the host's primary log file
+\vspace{0.3cm}
+\vspace{0.3cm}
+\vspace{0.3cm}
+\subsubsection{RPC name:~send\_debug\_keys}
+
+{\bf Overview:} 
+Inject the given string as debugging keys into Xen.
+
+ \noindent {\bf Signature:} 
+\begin{verbatim} void send_debug_keys (session_id s, host ref host, string keys)\end{verbatim}
+
+
+\noindent{\bf Arguments:}
+
+\vspace{0.3cm}
+\begin{tabular}{|c|c|p{7cm}|}
+ \hline
+{\bf type} & {\bf name} & {\bf description} \\ \hline
+{\tt host ref } & host & The host \\ \hline 
+
+{\tt string } & keys & The keys to send \\ \hline 
+
+\end{tabular}
+
+\vspace{0.3cm}
+
+ \noindent {\bf Return Type:} 
+{\tt 
+void
+}
+
+
+
 \vspace{0.3cm}
 \vspace{0.3cm}
 \vspace{0.3cm}
index a27c8756870fb239c3cd9d571efc839dc5ce08e4..f380f989d0bc6bc21ddeaa06a50099df0ed96393 100644 (file)
@@ -442,6 +442,20 @@ extern bool
 xen_host_dmesg_clear(xen_session *session, char **result, xen_host host);
 
 
+/**
+ * Get the host's log file.
+ */
+extern bool
+xen_host_get_log(xen_session *session, char **result, xen_host host);
+
+
+/**
+ * Inject the given string as debugging keys into Xen.
+ */
+extern bool
+xen_host_send_debug_keys(xen_session *session, xen_host host, char *keys);
+
+
 /**
  * List all supported methods.
  */
index 2ae37fefe4e874b95ec68fae4a9e1ee48263fa8e..a55b91e0af873538039ccb1864a94eab2b7022e6 100644 (file)
@@ -756,6 +756,39 @@ xen_host_dmesg_clear(xen_session *session, char **result, xen_host host)
 }
 
 
+bool
+xen_host_get_log(xen_session *session, char **result, xen_host host)
+{
+    abstract_value param_values[] =
+        {
+            { .type = &abstract_type_string,
+              .u.string_val = host }
+        };
+
+    abstract_type result_type = abstract_type_string;
+
+    *result = NULL;
+    XEN_CALL_("host.get_log");
+    return session->ok;
+}
+
+
+bool
+xen_host_send_debug_keys(xen_session *session, xen_host host, char *keys)
+{
+    abstract_value param_values[] =
+        {
+            { .type = &abstract_type_string,
+              .u.string_val = host },
+            { .type = &abstract_type_string,
+              .u.string_val = keys }
+        };
+
+    xen_call_(session, "host.send_debug_keys", param_values, 2, NULL, NULL);
+    return session->ok;
+}
+
+
 bool
 xen_host_list_methods(xen_session *session, struct xen_string_set **result)
 {